<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>EX3  ReadMe file </title>
</head>
<body>
<hr>
<hr>
<h1>EX3 :: Exercise 3 in Internet Programing and Java Language :: Voting system</h1>‫
<hr>
  <table width="100%">
    <tr>
      <td colspan="3"><h2>Students details</h2></td>
      <td><h2>Javadoc link</h2></td>
    </tr>
    <tr>
      <td><strong>Andrey Shamis</strong></td>
      <td>321470882</td>
      <td><a href="mailto:lolnik@gmail.com">lolnik@gmail.com</a></td>
      <td rowspan="2"><a target="_blank" href="dist/javadoc/index.html">Link to javadoc of EX3</a><br><em>Build with option for include private methods and variables</em></td>
    </tr>
    <tr>
      <td><strong>Ilia Gaysinsky</strong></td>
      <td>309480051</td>
      <td><a href="mailto:apalon83@gmail.com">apalon83@gmail.com</a></td>
    </tr>
  </table>
<hr>
<h2>Description of project</h2>

<hr>
<h2>How to use</h2>

<h3>How to build project files</h3>
&nbsp;For build the project please use NetBeans. <em>(<a href="http://netbeans.org/downloads/index.html" target="_blank">Download link</a>) Website netbeans.org .</em><br>
<br>
<hr>
 <h3>How to enter to this WEB page wich you build</h3>
 <p> The address to get vote it`s the path to your server then after slash put the folder wich conatin the files from ex3.war and on the run it`s must automaticaly set the default to Voting</p>
 <p>http://SERVER-DOMAIN/ex3/Voting</p>
 <hr>
<strong>Example For input file entry: </strong>
<pre>
http://www.hadassah.ac.il
http://google.com
</pre>
  <strong>Be sure that the input file by name (input.txt) is located in main derectory of the project!!!</strong>
<hr>
<h2>Some points - Futures</h2>
<h3>Future - Cookies</h3>
 &nbsp;In our project, we use a clever system of working with cookies.<br>
 In what appears the system:
 <ul>
   <li>First, the user can only vote <em>once for each</em> link.
   <li>Second user does not have to vote once for all links, that is, he can vote for as many options as he wants and it will next be able to vote for those for which he has not voted but it will not be able to vote for those for which he had voted before.
   <li>Thirdly there is also use cookies to count the number of users, that is, if a person has voted at least once, he scored once, if he will vote again this is not counted towards!
 </ul>
 <p><strong>Cookies</strong> will be stored for one<strong> month</strong>. It can be <strong>change</strong> in voting servlet.</p>
<h3>Future - Cookies/ Output Errors</h3>
&nbsp;Because of the technical features of the cookies as well as the specific approach this problem in our group. <br>
Which is manifested in the construction of forms of voting, which in turn is built dynamically for each user, depending on its previous votes. <br>
Therefore, in this case, we are also using cookies to store error numbers. <br>
Which can be two options: <br>
The first is the introduction of a null value or a letter <br>
and the second error is when the value entered is not suitable for a possible value.    <br><br>
At the same Advantages to face: <br>
<ul>
  <li><strong>We do not use java script </strong>
  <li><strong>The user who wants to vote two or more times for the same thing by pressing [F5]   will not be able to do so until an entry in the cookies. </strong>
</ul>
<h3>Future - Working with the input file  </h3>
&nbsp;Also our project can detect the absence of a file (<strong>file not exist</strong>) and show the error. <br>
But other than that the main feature is a file verification check on the occurrence of values in the file! <br>
That is, if the file suddenly for <strong>some reason was empty</strong>, then the error about it will be displayed that <strong>shows the input file is empty</strong>!
<hr>
<h3>Future - Exception report to Server Log file   </h3>
&nbsp;we have design  our code with grate debug report, we are printing any importante information to the Server Log file <br>
<ul>
  <li>start point of our Servlet - write: when the Servlet start to run (date and time)
        <ul>
            <li> for that featcher  we develop specific class that give the option to get current date and time in many formats (See "DateUtil" Class implementation)
        </ul>
  <li>any exceptions that happened also reported to the Server Log file
  <li>end of reading file
  <li>and match more
</ul>

<hr>

<h4>Bugs: no known bugs. </h4>  <br>
<hr>
<hr>
</body>
</html>